home *** CD-ROM | disk | FTP | other *** search
/ MacUser Mac Bin 28 / MACUSER-MACBIN28A-1996-03.ISO.7z / MACUSER-MACBIN28A-1996-03.ISO / Demo / MachTen 4.0.2 Demo / X Window Software / X11R5 / man / mann / xwininfo.0 < prev    next >
Text File  |  1995-08-14  |  7KB  |  193 lines
  1. NAME
  2.        xwininfo - window information utility for X
  3.  
  4. SYNOPSIS
  5.        xwininfo  [-help]  [-id  id]  [-root]  [-name name] [-int]
  6.        [-children] [-tree]  [-stats]  [-bits]  [-events]  [-size]
  7.        [-wm] [-shape] [-frame] [-all] [-english] [-metric] [-dis-
  8.        play display]
  9.  
  10. DESCRIPTION
  11.        Xwininfo is a utility  for  displaying  information  about
  12.        windows.   Various  information  is displayed depending on
  13.        which options are selected.  If  no  options  are  chosen,
  14.        -stats is assumed.
  15.  
  16.        The  user  has  the  option of selecting the target window
  17.        with the mouse  (by  clicking  any  mouse  button  in  the
  18.        desired window) or by specifying its window id on the com-
  19.        mand line with the -id option.  Or instead  of  specifying
  20.        the  window by its id number, the -name option may be used
  21.        to specify which window is desired by name.  There is also
  22.        a  special  -root  option to quickly obtain information on
  23.        the screen's root window.
  24.  
  25. OPTIONS
  26.        -help   Print out the `Usage:' command syntax summary.
  27.  
  28.  
  29.        -id id  This option allows the user to  specify  a  target
  30.                window  id  on  the command line rather than using
  31.                the mouse to select the target  window.   This  is
  32.                very  useful in debugging X applications where the
  33.                target window is not mapped to the screen or where
  34.                the use of the mouse might be impossible or inter-
  35.                fere with the application.
  36.  
  37.  
  38.        -name name
  39.                This option allows the user to  specify  that  the
  40.                window named name is the target window on the com-
  41.                mand line rather than using the  mouse  to  select
  42.                the target window.
  43.  
  44.  
  45.        -root   This  option specifies that X's root window is the
  46.                target window.  This is useful in situations where
  47.                the root window is completely obscured.
  48.  
  49.  
  50.        -int    This option specifies that all X window ids should
  51.                be displayed as integer values.  The default is to
  52.                display them as hexadecimal values.
  53.  
  54.  
  55.        -children
  56.                This  option causes the root, parent, and children
  57.                windows' ids and names of the selected  window  to
  58.                be displayed.
  59.  
  60.  
  61.        -tree   This  option  is  like  -children but displays all
  62.                children recursively.
  63.  
  64.  
  65.        -stats  This  option  causes  the   display   of   various
  66.                attributes  pertaining to the location and appear-
  67.                ance of the  selected  window.   Information  dis-
  68.                played  includes  the  location of the window, its
  69.                width and height, its depth, border width,  class,
  70.                colormap id if any, map state, backing-store hint,
  71.                and location of the corners.
  72.  
  73.  
  74.        -bits   This  option  causes  the   display   of   various
  75.                attributes pertaining to the selected window's raw
  76.                bits and how the selected window is to be  stored.
  77.                Displayed  information  includes the selected win-
  78.                dow's bit gravity, window  gravity,  backing-store
  79.                hint,  backing-planes  value,  backing  pixel, and
  80.                whether or not the window has save-under set.
  81.  
  82.  
  83.        -events This option causes  the  selected  window's  event
  84.                masks  to  be  displayed.   Both the event mask of
  85.                events wanted by some client and the event mask of
  86.                events not to propagate are displayed.
  87.  
  88.  
  89.        -size   This  option  causes  the selected window's sizing
  90.                hints  to  be  displayed.   Displayed  information
  91.                includes:  for  both the normal size hints and the
  92.                zoom size hints, the  user  supplied  location  if
  93.                any;  the  program  supplied  location if any; the
  94.                user supplied size if any;  the  program  supplied
  95.                size  if any; the minimum size if any; the maximum
  96.                size if any; the resize increments if any; and the
  97.                minimum and maximum aspect ratios if any.
  98.  
  99.  
  100.        -wm     This  option  causes  the selected window's window
  101.                manager hints to be displayed.   Information  dis-
  102.                played  may include whether or not the application
  103.                accepts input, what the window's icon window # and
  104.                name  is,  where  the window's icon should go, and
  105.                what the window's initial state should be.
  106.  
  107.  
  108.        -shape  This option causes the  selected  window's  window
  109.                and border shape extents to be displayed.
  110.  
  111.        -frame  This  option  causes  window  manager frames to be
  112.                considered when manually selecting windows.
  113.  
  114.  
  115.        -metric This option causes all individual  height,  width,
  116.                and  x and y positions to be displayed in millime-
  117.                ters as well as number of pixels,  based  on  what
  118.                the  server  thinks  the  resolution  is. Geometry
  119.                specifications that  are  in  +x+y  form  are  not
  120.                changed.
  121.  
  122.        -english
  123.                This  option  causes all individual height, width,
  124.                and x and y positions to be  displayed  in  inches
  125.                (and  feet, yards, and miles if necessary) as well
  126.                as number of pixels. -metric and -english may both
  127.                be enabled at the same time.
  128.  
  129.  
  130.        -all    This option is a quick way to ask for all informa-
  131.                tion possible.
  132.  
  133.  
  134.        -display display
  135.                This option allows you to specify  the  server  to
  136.                connect to; see X(1).
  137.  
  138. EXAMPLE
  139.        The  following  is  a sample summary taken with no options
  140.        specified:
  141.  
  142.        xwininfo: Window id: 0x60000f "xterm"
  143.  
  144.          Absolute upper-left X: 2
  145.          Absolute upper-left Y: 85
  146.          Relative upper-left X:  0
  147.          Relative upper-left Y:  25
  148.          Width: 579
  149.          Height: 316
  150.          Depth: 8
  151.          Visual Class: PseudoColor
  152.          Border width: 0
  153.          Class: InputOutput
  154.          Colormap: 0x27 (installed)
  155.          Bit Gravity State: NorthWestGravity
  156.          Window Gravity State: NorthWestGravity
  157.          Backing Store State: NotUseful
  158.          Save Under State: no
  159.          Map State: IsViewable
  160.          Override Redirect State: no
  161.          Corners:  +2+85  -699+85  -699-623  +2-623
  162.          -geometry 80x24+0+58
  163.  
  164.  
  165. ENVIRONMENT
  166.        DISPLAY To get the default host and display number.
  167.  
  168. SEE ALSO
  169.        X(1), xprop(1)
  170.  
  171. BUGS
  172.        Using -stats -bits shows some redundant information.
  173.  
  174.        The -geometry string displayed must make assumptions about
  175.        the window's border width and the behavior of the applica-
  176.        tion and the window manager.  As a  result,  the  location
  177.        given is not always correct.
  178.  
  179. COPYRIGHT
  180.        Copyright 1988, Massachusetts Institute of Technology.
  181.        See X(1) for a full statement of rights and permissions.
  182.  
  183. AUTHOR
  184.        Mark Lillibridge, MIT Project Athena
  185.  
  186. X Version 11                Release 5                           3
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.